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New commands for cycling gadgets, radio buttons, AGA screens, 
filled polygons 'and more. Plus free demo of Skidmarks our latest 
inhouse Blitz2 project which will knock your socks off. Beta version 
of our new Intuitools to plan your applications with and heaps of 
hints and tips for programming in Blitz2. And a compilation of the 
Australasian questionaires that have been returned by Down Under 
Blitz2 Users, Thanks Guys! Simon :) 



BACK IN 
THE OFFICE... 

More gossip from the St Kevins Arcade office of Acid Software & 
Vision Software... 

Severe hardware problems have been encountered over the last few 
weeks, suprisingly we were to find out, all caused by the office mousel 
Gee all those computers and only one mouse you ask, well this mouse 
is kind of different, he seems to like crawling inside computers via rear- 
expansion slots and bedding down for the night, and what really sucks, 
is that he has been having quite a few wet dreams!!! These adolescent 
rodent fantasies have already been responsible for taking out an entire 
A2000 mother board (oh dear, now we're getting into incest), and levels 
of corrosion on two other machines are severe. 



Struth cobbers! It seems that every time we get any good press in the 
English Amiga mags they flatter us buy calling us AUSTRALIANS! Now 
come on fellas, just because we're on the other side of the world 
doesn't mean you can lob insults at us with out fear of reprimand! So be 
on your guard! And speaking of Australia, Acid Software will be 
represented in Sydney first-third of July at the World Of Commodore 
show. So if you're coming, don't forget to bring along your latest Blitz2 
programs to show us what you're up to. 

Skidmarks? What kind of a name for a game is that you ask... A pretty 
catchy one if you ask me! Anyway, it is likely to be the first software 
developed in Blitz2 to be released on a commercial basis. Hopefully in 
a software shop near you mid July, featuring 6 tracks, better computer 
competition etc. Congratulations to Andrew for prooving you can write 
such addictive software in Blifz2, hopefully it will spur other Blitz Users 
to reach greater heights. 



Anyway, besides the loud 4 player skidmark competetions (thats the 
computer version) its been heads down and hard at work. A new game 
is on it's way from Vision, this time its a rotating helicopter blaster that 
has to be seen to be beleived (nothing cute about this hell raiser). CD of 
the month goes to Aerosmith (even though nobody here likes it), drug 
of the month goes to Nicobrevin which is aiding me in another attempt 
to kick the cancer sticks.... 
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EDITORIAL 



Happy Happy, Joy Joy, it's 
another issue of Blitz User, 
woza, intact it's issue 4! The 
good news is that we now have 
100% German manuals 
available, are hack in stock of 
English packages and are 
looking forward to selling 
heaps of Blitz BASIC'S in the 
next few months. 

Those interested in developing 
applications in B Iitz2 will 
appreciate the new features this 
month. We have extended the 
gadgets library to handle 
cycling text gadgets and 
exclusive gadgets (radio 
buttons). Plus there's support 
for some AGA screen modes as 
well as 24 bit AGA palette 
handling. 

On my side I've extended the 
commands in the 21) drawing 
library to handle bitmaps larger 
than l()24x 1024 and also added 
polygon drawing commands. 

Everything should be stable on 
accelerated Amiga's now that 
we have sorted out vector base 
relocation stuff. The debugger 
and hi -frequency AGA screen 
modes are still not compatible. 
We will have a display 
independent debugger option 
available soon, until then, 
you'll need to stick with 50- 
6 II z displays while 
developing stuff in Blitz2. 

We had excellent responses 
from the questionaire that went 
out with issue 3. This month 
features a compilation of 
results from our Australasian 
Blitz Users. Next issue we will 
cover the German and U.S. 
responses. 

What we would dearly like to 
see now from Blitz Users are 



programs written in Blitz2. It's 
all very well to harp on about 
support for AGA and 3.0, but 
surely the primary objective is 
to develop software that will 
run on ALL Amigas. 

Besides the software we have 
developed here in NewZealand 
with Blitz2 1 have not seen or 
heard of anything thats being 
developed by Blitz Users. Sure 
we receive lots of messages 
regarding stuff you guys want 
added but it would certainly 
help the cause if we got a disk 
every now and then with 
programs people are working 
on. Otherwise it starts to feel as 
though Blitz2 is just our in- 
house development language... 

Hmmm, what else is in this 
issue. Well I could go on about 
Skidmarks, it's certainly 
waisted enough of my time 
play testing it for Andrew :) 
With the new tracks added I'm 
really looking forward to 
showing that not only can you 
write commercial quality 
software in Blitz2 but you can 
write chart-topping software in 
Blitz2 as well. 

O.K. so whats on the top of our 



list of things to do now that 
issue 4 is finished? For starters 
we need AGA support in Blitz 
mode so we can get a 256 
colour version of skidmarks 
released. Hi-frequency 
debugging is high on the list. 

I'll be polishing off the new 
Intuitools program and 
hopefully get it to generate 
most of the code for the user 
interface so programmers can 
concentrate on the core routines 
etc. 

Mark has been working on his 
own 3D library and has 
developed a rather amazing 3D 
shape editor. Hopefully that 
and the library will be ready for 
next issue. In the mean time 
check out the darts demo on the 
cover disk and have a play with 
some of the control routines. 

Anyway, please try and send us 
some demos of what you are 
working on. The result will be 
that we work even harder on 
improving Blitz2 for you! 



Keep hacking... 



SIMON 
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LETTERS 



DearBlitzMan 

I am a registered owner 
of both the original Blitz 
Basic and Blitz2. Using 
Blitz I wrote "Sword of 
the Warlock" a Bard's 
Tale type game. I've sold 
a small number of copies 
and received a lot of 
compliments about it. 
Now I'd like to upgrade 
Warlock using BIitz2. 

I sent Acid Software in 
Mesa Arizona my $15.00 
for the annual newsletter 
sub and after several 
months still have no 
newsletter or disk 
updates. I can't tell you 
how important it is that I 
get some help. I want to 
begin programming but 
can't really start unless I 
have all the commands I 
need. 

Thanks for your time and 
help. 

Alan Broz 



Alan, you could have 
sent a copy of Sword of 
Warlock with the letter! 
Anyway sorry about the 
U.S. support for Blitz2. 



Hopefully things are now 
straightened out and you 
have got hold of the 
previous upgrades and 
can start porting the 
game to Blitz2, look 
forward to hearing how 
you get on. 



Dear BlitzMan 

Blitz2.0 is working fine, 
however I have a few 
questions: 

* When compiling a 
custom library do 1 use 
the Create File or 
Create Resident option? 

* When compiling the 
custom library I continue 
to get "Wrong Number 
of Parameters" on the 
!subs line 

* How do I change the 
timing of the 
soundtracker player for 
proper replay on NTSC 
machines 

* Do you have a BBS 
where registered users 
can get access to update 
files. 

Mike Hurt 



Mike, thanks for your 
letter. You need to 
"Create File" when 
compiling a custom 
library such as that 
found in issue #1 of 
BUM. Make sure you are 
using curly brackets 
when calling macros 
such as /subs, also you 
n e e d t o s u p p I y 3 
parameters. (More info 
in BUMU2) 

At the moment we do not 
have support for correct 
soundtracker replay on 
NTSC machines, we'll 
get onto it. As for the 
BBS, we should have one 
up and running in the 
U.S. 

Call Dave Maziarka on 
(608)257- 1 975 for more 
information. 



Dear Blitzman, 

I have been using Blitz2 
for a couple of weeks 
and beleive it to be a 
pretty good language 
with a lot of potential, 
although there are quite a 
few places where BBS 
could stand a great deal 
of improvement, namely 
the editor: 
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1st up the Language in 
General: 

1 . access to system date 

2. ability to access bold, 
italics and underlining 
when printing to both 
the screen and especially 
the printer 3. access to 
speech synthesiser 

2nd the editor: 

1 . use of any font rather 
than the two supplied 

2. when you hit return 
the editor should open a 
new line at the current 
cursor position 

3. backspace should 
delete end of line 
characters 

4. auto indenting of 
structure code 

If these few changes 
were implemented there 
is no telling how far this 
language could go in the 
Amiga community. 1 for 
one would recommend 
your language to my 
friends and fellow 
Amiga users. 

As it is now I have a 
slight problem 
recommending your 
program because of 
these slight 
imperfections... 

Thanks for your kind 
attention... 



Dewey A Fish 

Hi Dewey, thanks for 
your comments. We have 
had LOTS of complaints 
about TED, and 
hopefully we will 
upgrade him again soon 
including most of the 
features you mention. 

As for the compiler, we 
have support for speech 
and system date/time 
stuff already, print codes 
etc. hopefully next 
month. Stay Tuned! 



Dear Blitzers, 

A friend of mine uses 
Blitz2 and swears that it 
is the best thing he has 
ever seen. I saw some of 
the stuff he has done and 
I was really impressed. 

I just recently bought an 
A 1 200. Do you have a 
version of Blitz2 which 
supports the AGA 
modes as well as the 
standard ones? If so 
when will it be 
available? 

Hope to hear from you 
soon 

Kevan Stannard. 



Yo Kevan, If you're 
reading this at your 



friends place then you'll 
be pleased to see the 
inclusion of some of the 
AGA stuff you requested 
in this issue. If you've 
gone and bought Blitz2 
and registered then I 
suppose you'll be even 
happier that you can start 
messing with 24 bit color 
etc. right away. 



If you have any 
comments about 
Blitz2 or just want 
to say hi and let us 
know what you are 
working on at the 
moment then 
please, drop us a 
line! 

Send mail to: 

10 StKevins Arcade 
Karangahape Road 
Auckland 
New Zealand 

or send us a fax on: 

+649 358 1658 
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Blitz 2 Questionnaire 
Australasian Results 



The following is the results from the 40 or so 
questionaires returned from Australasian Blitz 
Users. German and U.S. results will be 
published in issue 5 of Blitz User Magazine. 

Hardware 

On the hardware front I was quite suprised to 
see how many people have upgraded to the 
new A1200 machine. We've got two in the 
office and although we still haven't added any 
fastmem to them due to the stupid prices, 
they seem to be a fast reliable machine. 

So stats for the different Amigas are: 



A500 users 
A1 200 users 
A2000 users 
A1 000 users 
A3000 users 
A4000 users 

A600 users 



= 44% 
= 18% 
= 18% 
= 7% 
= 7% 
= 7% 
= 0% 



(wo, popular machine!) 
Also 56% of Blitz Users have modems. 



Languages 

As was suspected Amos and Arexx come in 
tops, to be expected I suppose, quite a few 
people have been messing around with E 
which we have also had a dabble with. 



AMOS 


25% 


AREXX 


25% 


AMIGABASIC 


8% 


CANDO 


8% 


E 


5% 


C 


5% 


ASSEMBLER 


5% 


GFA 


3% 


PASCAL 


0% 



(for A600 owners only!) 

Not as many assembler programmers as I 
expected, maybe I'm the only one who 
regards Blitz2 as the best assembler around, 
oh well... 



Using Blitz2 

Well, you couldn't get a more mixed bag than 
asking what type of programs people wanted 
to develop in Blitz2. This of course doesn't 
make our job any easier having to cater for 
every man and his dog! 

The main things that stood out were perhaps 
a need for better audio control and some 
discussion on calling DOS commands from 
Blitz2. 

The results for types of programs users were 
keen on developing were: 



Utilities 

Games 

Strategy 

Music 

Educational 

Graphics 


50% 
41% 
12% 
12% 
10% 
8% 


Conclusion 



Overall, the general consensus was that 
people were happy with Blitz2, a lot were 
having trouble getting to grips with the 
documentation (which is an ongoing job for 
us) and we were definately not supporting the 
beginners enough. 

There is a new User Guide that users can 
upgrade to (included in German manual), and 
we will be developing a series of beginner 
tutorials to coincide with a special magazine 
promotion that we will be starting in the U.K. 
shortly. 

Anyway, if you haven't returned your 
guestionaire please do so today, we will be 
doing another at the end of the year to try and 
gauge where we are heading and to keep up 
to date with what you the user need from 
Blitz2, the language that just keeps on 
growing! 

German & U.S. scores next month... 
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This column has been reinstated after 
several issues which, yes OK we did have 
lots of bug reports, well anyway this will be 
a regular feature. 

Once again, if you find a bug in Blitz2, have 
some serious problems with the 
documentation please drop us a line, 
otherwise, how do we know to fix them???? 

Compiled list of bugs fixed since release... 

Accelerated Amigas have the ability to 
relocate trap and interupt vectors in 32 bit 
memory, Blitz2 now handles this minor 
inconvenience. 

All bitmap based drawing commands can 
now be used on bitmaps larger than 
1024x1024. 

Program exit from Blitz mode was slightly 
hairy due to Blitz2 not waiting for a 
BlitFinished at the right time, all fixed now. 

Rastport and ViewPort were returning 
wrong results in the first release, not 
anymore. 

"Variable Already Shared" compile time 
messages were appearing for no logical 
reason, its been sussed. 

Multiple byte fields in NewTypes were 
causing odd address problems until v1 .5 or 
so, v1 .6 has no such problems. 

Ted lost the German chars and went NTSC 
uncompatible in v1.5, he's recovered and is 
now in a stable condition. 

Slices on AGA machines were crapping out 
until AGA arrived in NewZealand, as soon 
as this happened (6 months after the rest of 
the world) it was sorted out. 

The optimiser was removed due to it's 
ability to generate non 680x0 compatible 



code, may reappear in the near future. 



Square brackets were causing a few 
problems in NewTypes this was fixed 
around v1 .3. 

The .info of source and object code is not 
overwritten by Ted if it already exists so 
image and position are not stuffed up by 
resaving/creating your program. 

In version 1.5 or so, the system libraries 
were overhauled to handle the release of 
3.0. This meant a LOT of the tokens were 
changed and source code was NOT 
backward compatible! SORRY. Anyway, to 
get round this problem, programs that use 
operating system calls should be loaded 
into the older version of Blitz2, saved as 
ascii (using Write-Block), and THEN loaded 
into new version of Blitz2. This problem is 
applicable to the QUICK-ASM example on 
the examples disk. 
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AGA PALETTE HANDLING 

Blitz 2's palette object has (again) changed. Palette objects are now capable of 
containing AGA compatible 24 bit colours. 

The new palette objects look likethis: 

NEWTYPE.rgbcomp 

_red.l ;left justified red component. 

_green.l ;left justified green component. 

_blue.l ;left justified blue component. 

End NEWTYPE 

NEWTYPE.palettedata 

_numcols.w .same as palette/_numcols. 

_zero.w ;for compatibility with graphics lib LoadRGB32. 

_rgbs.rgbcomp(256) ;256 is the max... the amount will actually 

.depend upon the highest accessed palette entry. 
_zero2.l ;for graphics lib too. 

End NEWTYPE 

This is the actual object return by Addr Palette(n): 

NEWTYPE.palette 

_*data.palettedata ;00: NULL if no palette present, else a pointer to 

; palettedata. 
_numcols.w ,04: number of colours present in palettedata. 

.below is colour cycling Info. 
Jowcol.w .06: low colour for cycle range. 

_hicol.w ,08: high colour for cycle range. 

_speed.w ; 10: speed of cycle : 16384 = max speed, sign of speed 

; indicates cycling direction. 

.12: cvariable speed is added to. 



var.w 



End NEWTYPE 



more possible cycling entries.... 
128:sizeof. 



Now for the new AGA functions added to Blitz 2... these will all generate 
a runtime error if used on a non-AGA Amiga: 



Statement: AGARGB 

Syntax: AGARGB Colour Register,Red,Green,Blue 

Modes: Amiga 

Description: 

The AGARGB command is the AGA equivalent of the RGB command. The 'Red', 'Green' and 
'Blue' parameters must be in the range through 255, while 'Colour Register' is limited to the 
number of colours available on the currently used screen. 
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Example: 

; AGA test 

• 

Screen 0,0,0,1 280,51 2 > 8,$8024,"SUPER HIRES LACED 256 COLOR SCREENM.2 
ScreensBitMap 0,0 

For i=0 To 255 

AGARGB i,i/2,i/3,i ,shades of purple 

Circle 640,256,i*2,l,i \big SMOOTH circles 
Next 

MouseWait 

Statement: AGAPalRGB 

Syntax: AGAPalRGB Palette/t, Colour Register,Red,Green,Blue 

Modes: Amiga 

Description: 

The AGAPalRGB command is the AGA equivalent of the PalRGB command. AGAPalRGB 
allows you to set an individual colour register within a palette object. This command only sets 
up an entry in a palette object, and will not alter the actual screen palette until a 'Use Palette' 
is executed. 



Function: AGARed 



Syntax: AGARed (colour register) 

Modes: Amiga 

Description: 

The AGARed function returns the red component of the specified colour 
register within the currently used screen. The returned value will be within 
the range (being no red) through 255 (being full red). 



Function: AGAGreen 



Syntax: AGAGreen (colour register) 

Modes: Amiga 

Description: 
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The AGAGreen function returns the green component of the specified colour register within 
the currently used screen. The returned value will be within the range (beinq no qreen) 
through 255 (being full green). 



Function: AGABlue 

Syntax: AGABlue (colour register) 

Modes: Amiga 

Description: 

The AGABlue function returns the blue component of the specified colour register within the 
currently used screen. The returned value will be within the range (beinq no blue) throuoh 
255 (being full blue). / ** 

NEW SCREEN FLAGS 

The superhires viewmode flag $20 is now acceptable, but should always be used in 
conjunction with the standard hires flag of $8000. 

The depth of a screen may now be specified up to 8 bitplanes (256 colours) deep (if you've got 
an AGA machine!). Here's how you would go about opening a superhires, 256 colour screen: 

Screen 0,0,0, 1280,256,8,$8020,"MyScreenM ,0 



3.0 BITMAP HANDLING 

Blitz 2's Bitmap object has been upgraded to allow for interleaved bitmaps: 

NewType.Bitmap 

ebwidth[0] 
_ linemod.w 
_ height.w 
_ depth.w 
_ pad.b[2] 
_ data.l[8] 
_ pad2.b[12] 
_ flags.w 
_ bitplanemod.w 
_ xclip.w 
_ yclip.w 
_ cclip.w 

isreal.w 



End NEWTYPE 



;00: for compatability. 

;00: value to get from one scanline to next. 

;02: currently pixel height - but open to commodore 'enhancement'. 

04: number of bitplanes. 

06: nothing. 

08: actual bitplane pointers. 

40: zilch. 

0=normal bitmap, <0=interleaved. 

value to get from one bitplane to next. MAY BE 0! 

pixel width for render clipping 

pixel height for render clipping 

number of colours available on bitmap ( = 2 A _depth) 

0=no bitmap here, <0=blitz created bitmap, >0=borrowed 

64: sizeof 



Also, many Blitz2 bitmap related commands have been altered to take this new object into 
account. 
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NEW GADGET HANDLING 



A new bit, bit 9, in the 'Flags' parameter of the TextGadget' and 'ShapeGadget* commands 
allow you to create mutually exclusive radio button type gadgets. These gadgets DO NOT 
require Kickstart 2.0 to operate! 

Here is an example of setting up some radio button style text gadgets: 

TextGadget 0,16,16,512,1 ."OPTION 1":Toggle 0,1, On 
TextGadget 0,16,32,512,2/OPTION 2" 
TextGadget 0,1 6,48,51 2,3,"OPTION 3" 

The new 'ButtonGroup' command allows you to specify which 'group' a series of button 
gadgets belong to. See 'ButtonGadgef below. 

Note that if you are using button gadgets, you SHOULD really toggle ONE of the gadgets 'On* 
before giving the gadgetlist to a window - as in the example above. 

Text Gadgets may now be used to create 'cycling* gadgets. Again, these gadgets DO NOT 
require kickstart 2.0 to work. 

If you create a text gadget which contains the 'I ' character in the gadget's text, Blitz 2 will 
recognize this as a 'cycling' gadget, using the 'I ' character to separate the options - like this: 

TextGadget 0,16,16,0,1," HELLO I GOODBYEI SEEYA I " 

Now, each time this gadget is clicked on, the gadgets text will cycle through 'Hello', 
'GOODBYE' and 'SEEYA'. Note that each option is spaced out to be of equal length. This 
feature should not be used with a GadgetJam mode of 0. 

Now for the new gadget commands: 



Function: GadgetStatus 



Syntax: GadgetStatus (GadgetLlsWJd) 

Modes: Amiga 

Description: 

GadgetStatus may be used to determine the status of the specified gadget. In the case of 
'toggle* type gadget, GadgetStatus will return true (-1) if the gadget is currently on, or false (0) 
if the gadget is currently off. 

In the case of a cycling text gadget, GadgetStatus will return a value of 1 or greater 
representing the currently displayed text within the gadget. 
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Statement: ButtonGroup 



Syntax: ButtonGroup Group 

Modes: Amiga 

Description: 

ButtonGroup allows you to determine which 'group* a number of button type gadgets belong 
to. Following the execution of ButtonGroup, any button gadgets created will be identified as 
belonging to the specified group. The upshot of all this is that button gadgets are only mutually 
exclusive to other button gadgets within the same group. 

'Group* must be a positive number greater than 0. Any button gadgets created before a 
'ButtonGroup' command is executed will belong to group 1 . 



Function: Buttonld 



Syntax: Bu\lon\d(GadgetList#, ButtonGroup) 

Modes: Amiga 

Description: 

Buttonld may be used to determine which gadget within a group of button type gadgets is 
currently selected. The value returned will be the Gadgetld of the button gadget currently 
selected. 



Statements: Enable & Disable 

Syntax: Enable GadgetLisWJd & Disable GadgetLisWJd 

Modes: Amiga 

Description: 

A gadget when disabled is covered by a "mesh" and can not be accessed by the user. The 
commands Enable and Disable allow the programmer to access this feature of Intuition. 



Statement: SetGadgetStatus 

Syntax: SetGadgetStatus GadgetList#,ld,Value 

Modes: Amiga 

Description: 

SetGadgetStatus is used to set a cycling text gadget to a particular value, once set ReDraw 



Blitz User Issue 3 13 



should be used to refresh the gadget to reflect It's new value. 
NEW GADGETS EXAMPLE: 

new gadget types 

WBStartup:FlndScreen \open on workbench 

TextGadget 0,32,14,0,0,"CYCLE 1 1 CYCLE 21 CYCLE 3" cycling gadget 

ButtonGroup 1 ; first group of radio buttons foliows 

For 1=1 To 5:TextGadget 0,32, 14+i*1 4,51 2,i,"CHANNEL #"+Str$(i):Next 

ButtonGroup 2 \second group of radio buttons follows 

For l=6 To 10:TextGadget 0,32,14+I*14,512,I,"BAND #"+Str$(i):Next 

Window 0,20,20,1 60, 180,$1008,"GADGET TEST\1,2,0 \open window with gadgets 

Repeat ; wait until close window gadget hit 

ev.l=WaitEvent 
Until ev=$200 

DATE & TIME COMMANDS 

Function: SystemDate 



Syntax: SystemDate 

Modes: Amiga 

Description: 

SystemDate returns the system date as the number of days passed since 1/1/1978. 

Example: 

date/time test 

Dim d$(6):Restore daynames:For i=0 To 6:Read d$(i):Next 
Dim m$(12):Restore monthnames:For i=1 To 12: Read m$(i):Next 

NPrint Date$(SystemDate) 

NPrintd$(WeekDay)," ".Days," ",m$(Months) t " ".Years 

NPrint Hours,":",Mins,":",Secs 

NPrint "press mouse to quit" 

MouseWait 

daynames: 

DataSSUNDAY.MONDAY.TUESDAY.WEDNESDAY.THURSDAY.FRIDAY.SATURDAY 

monthnames: 

Data$JAN,FEB,MAR,APR,MAY,JUN,JUL,AUG,SEP.OCT,NOV,DEC 
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Function: Date$ 



Syntax: Date$ (days) 

Modes: Amiga 

Description: 

Date$ converts the format returned by SystemDate (days passed since 1/1/1978) into a string 
format of dd/mm/yyyy or mm/dd/yyyy depending on the dateformat (defaults to 0). 



Function: NumDays 



Syntax: NumDays (date$) 

Modes: Amiga 

Description: 

Numdays converts a Date$ in the above format to the day count format, where numdays is the 
number of days since 1/1/1978. 



Statement: DateFormat 



Syntax: DateFormat format* ; or 1 

Modes: Amiga 

Description: 

DateFormat configures the way both date$ and numdays treat a string representation of the 
date: 0=dd/mm/yyyy and 1=mm/dd/yyyy 



Functions: Days Months Years & WeekDay 

Syntax: Days Months Years & WeekDay 

Modes: Amiga 
Description: 

Days Months and Years each return the particular value relevant to the last call to 
SystemDate. They are most useful for when the program needs to format the output of the 
date other than that produced by date$. WeekDay returns which day of the week it is with 
Sunday=0 through to Saturday=6. 
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Functions: Hours Mins & Sees 

Syntax: Hours Mins & Sees 

Modes: Amiga 

Description: 

Hours, Mins and Sees return the time of day when SystemDate was last called. 



ENVIRONMENT COMMANDS 

Functions: WBWidth Height Depth & ViewMode 

Syntax: WBWIdth, WBHeight, WBDepth & WBViewMode 

Modes: Amiga 

Description: 

The functions WBWidth, WBHeight, WBDepth & WBViewMode return the width, height, depth 
& viewmode of the current Workbench screen as configured by preferences. 



Functions: Processor & Exec Version 

Syntax: Processor & ExecVersion 

Modes: Amiga 

Description: 

The two functions Processor & ExecVersion return the relevant information about the system 
the program is running on. The values returned are as follows: 



ExecVersion 


OperatingSystem Release 


33 
34? 
36 
39 


1.2 
1.3 
2.0 
3.0 



Processor 


Part# 





68000 


1 


68010 


2 


68020 


3 


68030 


4 


68040 
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NEW DRAWING COMMANDS 

Statement: Poly & Polyf 

Syntax: Poly numpoints,*coords.w,color & Polyf numpoints,*coords.w,color(,color2] 

Modes: Amiga/Blitz 

Description: 

Poly & Polyf are bitmap based commands such as Box and Line. They draw polygons 
(unfilled and filled respectively) using coordinates from an array or newtype of words. Polyf 
has an optional parameter color2, if used this colour will be used if the coordinates are listed in 
anti-clockwise order, useful for 3D type applications. If color2= -1 then the polygon is not 
drawn if the verticies are listed in anti-clockwise order. 

Example: 

polygon test using triangle newtype 

NEWTYPE .tri:x0.w:yO:x1:y1:x2:y2:End NEWTYPE 

BLITZ 

BitMap 0,320,256,3 

Slice 0,44,3:Show 

While Joyb(0)=0 

a.tri\x0=Rnd(320),Rnd(256),Rnd(320),Rnd(256),Rnd(320),Rnd(256) 

Polyf 3,a,1+Rnd(7) 
Wend 



Statement: BitPlanesBitMap 



Syntax: BitPlanesBitMap SrcBitMap, DestBitMap, PlanePick 

Modes: Amiga/Blitz 

Description: 

BitPlanesBitMap creates a 'dummy' bitmap from the SrcBitMap with only the bitplanes 
specified by the PlanePick mask. This is useful for shadow effects etc. where blitting speed 
can be speed up because of the fewer bitplanes involved 



Statement: ClipBlit 



Syntax: ClipBlit Shape#,X,Y 
Modes: Amiga/Blitz 
Description: 



ClipBlit is the same as the Blit command except ClipBlit will clip the shape to 
used bitmap, all blit commands in Blitz2 are due to be expanded with this fea 



the inside of the 
feature. 
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Tri Analyse 

Hi again to an you Blitz people out there. Well its early June and here in 
New Zealand that means cold miserable winter. Perfect for programming 
computers but terrible for triathlon training. 

Triathlon training? Wetl the reason I brought that up is that is what the 
accompanying programme is alt about, It's a triathlon training database that 
allows you to enter you various types of training into into a data file and 
retrieve them with ease. It will also perform some graphing functions which 
II go into later. 

This programme shows you that Blitz is not just for writing games (though it 
certainly is good at it) but can quite happily generate applications software 
Tri Analyse is reasonably complex and demonstrates how to do the 
following things. 

Set up screens & windows 

Set up gadgets inckiding textgadgets, string gadgets, and showing some of 
the new gadget commands presented elsewhere in this issue like mutual 
exclude gadgets, and disabled gadgets 

It also shows how convenient Newtypes are lor storing records how 
creating functions and statements can tidy up your code, and save you 
typing! 

How to use the Amiga's inbuilt library functions from within BliU 
And much morel 

As this is Blitz User Magazine and not a fitness publication I have put a 
ascii file called TriReadMe.Doc in the Tri directory on the cover disk, for 
details of how to use the programme please refer to that, If you are a 
triathlete or cyclist or runner, I would hope that you find it useful, drop us a 
line and let us know about your training. 

Right, on with a description of the programming for all you code heads out 
there. 

I split Tri Analyse into two separate listings, the first (Tri.inc) contains all the 
function and statement definitions used by the main programme, the 
function is a Yes No requester which returns a true or false value for the 
main programme, and the statement is a simple alert requester to bring the 
users attention to something. It then defines all the Newtypes (structures) 
for the records to be stored in. When writing a database type programme 
such as this you need to work backwards, the first thing you have to do is 
decide on what you want the programme to output, my requirements were 
as follows. 

1. Each diskfUe had to contain 1 months worth of training 

2. Each day could handle information for all 3 disciplines of the triathlon, 
Swimming, CycHng, and Running. 

3. Each discipline had to hold the resting heartrate, what type of training 
was actually done, and a string that described the training for the day. 

With this in mind I ended up with the following newtypes and arrays. 

NEWTYPE.dota 
spare.w .just in case 
heartrate.w jieartratelnBPM 
trdn.w ;0 - endurance 1 * aerobic 

;2- sprint (speed training) 
texts .editor generated text. 

EndNEWTYPE 



NEWTYPE.file ;tNs Is the record for a DAY 

dis.data(3) .Inctode the dda newtype 3 times for the 3 .aTscOl 

;2 Swimming 0. cycling 1 . runnhg 2 
EndNEWTYPE 
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Dim current.file<32) ;aTm a 32 day month 1-31 fa convenience 

So we have a array called current, who has a subset of the newtype file, 
which has 3 subsets of the type data, In this way we can easily reference 
data for any discipline on any day example: 

To access the text about my cycle training on the 13th of a month would be 

thetextS = current(13)\dis(1]\text 

This is how newtypes and nested newtypes really come into their own. 
Right now that we have the data structure we needed to design the 
programme to fid it. 

First up I did the User Interface. Created your standard WBStyle 640x256 
PAL Screen (sorry American users use one of those PAL utils :) ) Then a 
window was generated, non draggable etc. simply for its ability to allow us 
to attach a gadgetUst, and use different sized fonts etc. 

Then the gadgets, these had to be put in before the window was opened 
obviously. I used GadgetBorder to divide the screen into logical segments 
for groups of different operations, GadgetBorder is a purely cosmetic 
function that does not affect gadgets at all but I think you will agree that it 
can make a display look a whole heap better. I set my gadgetpens to give 
the buttons (texgadgets) a 'raised look' and designed all those, then 
swapped the gadgetpens to give a 'reccessed' look and did all the 
StringGadgets. The last two Gadgets were designed with a bigger font and 
the GadgetPens were set for a raised look again. 

Also at relevant points through-out the code, various gadgets were 
assigned buttongroups (for the ones that were set up for mutual exclude) 
and certain gadgets were preset on or disabled completely (see later in this 
issue of BNtz User f 4 for details on the new Gadget commands.) 

Righl now the Interface was out the way. All that remained was the main 
gadget handling loop (the event loop), And the coding of all the subroutines 
to deal to the entered gadget data in a meaningful way. 

Ok. the way I had designed this programme In my mind the piece of dala on 
which ail others relied was the entering of a valid date, after all all the 
various bits of the newtype structures were reference from the date so il a 
valid date was not there then no entered data would be valid either. 

So the first subroutine I did was the checkdate one. 

The checkdate routine does quite a bit. the first thing it does is check the 
length of the string we entered since it wants OO/MM/YY format if the string 
is not the correct length (8) we can assume the date is invalid and tell the 
user if the length is correct we extract two sets of data the individual day 
month and year are stored as strings for use in the filesave and load 
routines, and are also converted to numeric variables for use in the various 
offsets in the arrays and newtypes. We then check the individual values for 
BASIC validity (we assume that every month could theoretically be up to 3 1 
days long as it does not affect the file, saves a lot of checking and at worst 
the user could create something like the 30th of Feb - A bit lazy on my part 
but no big deal.) If the date syntax is invalid we ted the user via a nifty alert 
function and set the date flag to false, at the end of this if the date is false, 
we clear the datetield and wait for the user to enter another date. 

Right, now that we've established that we have a valid date we set the date 
flag to true, we then check that the month we have asked for is not an 
already open file if we have asked for a new month, we save the old month 
(if there is no old month a dummy yearfHe will be written but this once again 
is a few bytes and not a problem. Now that we have saved the oldmonth we 
make the oldmonth the currentmonth and go and try and read our current 
month. If we successfully read it, we reset the fileread flag to false (so its 
rechecked nextime) otherwise, the read of the month must have failed so 
we have to create a new one, first of all we zero all the data fields so our 
new month does not get the last months data, and then we create the file. 

If way back at the first step the month of the date we entered was the 
SAME as the last entry we do NO file-handling, as it is already open. This 
routine is quite a groovy way of handling records as it eliminates excessive 
disk access and shields the user from having to load files. 

Now that the checkdate routine has been completed we then check to see if 
a valid date was the result again (by the date flag) and if so refresh our 



mutual exclude gadgets so that they take note ot any changes in training 
type on our new day, this has the advantage that if there is no training 
currently entered lor that day the two banks of gadgets are set to a known 
state (ie SWIMMING and ENDURANCE). 

All the other gadget events are to do with handling all the other bits of the 
programme like changing disciplines and training types, editing data, 
graphing it, saving data (as you need to do this for the last month you do 
before quitting the programme) setting our default editor type and quirting 
the prog, lets take a brief look at a few of these routines. 

1. Selecting your own text editor 

I am too lazy to write my own text editor, also they are rather a beast to 
write so rather than re-invent the wheel I've decided to take advantage of 
Blitz 2's ability to utilise the Amigas operating system calls. The call I am 
using here is the 'Execute.' function, which goes away and executes a 
programme. One annoying thing about the Execute, function is that it 
requires the Run command to be present in the C: directory but that is the 
norm rather than the exception so as long as the user is told about this in 
the documentation its OK. 

The other thing to be wary about the execute command is that some 
programmes run as a detached process, this means when you execute 
them they run, but detach themselves from your programme and return 
control to your programme, Cygnus-Ed is an example of a editor that does 
this. This 'feature' sucks as far as we are concerned so use a nice 
ATTACHED editor such as TED or Ed or something. 

So to implement a Editor in our programme we have done two things 

1. Given the user the ability to enter his own command string for his editor 
of choice and save it in a preferences or config fie so that its aH set up for 
him next time (Case 3 in the main loop) 

2. When the person goes to edit some text we once again check for a valid 
date, then call the Execute) function with the pathname and the command 
for the editor, and two nulls for the other arguments. We return a result that 
we check for success, but I have since found out that Execute returns a 
true result even if the execution of the command was not successful. GO 
FIGURE? This It not to much of • prob cos the average clued up user Is 
going to go 'Hmmm no editor here, perhaps my command string Is wrong' 
and go and fix the problem. 

I am also making the rather naughty assumption that everyone Is going to 
have a ram: disk as I originally wrote this programme for my own use only 
and only decided to put It on blitz user at the last minute. So if you don't 
have a ram disk, you can substitute your own desired disk device and 
recompile the source, (if its someone that does not own Blitz Basic - Tuff 
luck:-) 

the user is then to enter the text which gets saved in a file catfed ram:temp 
which upon exiting the editor we store in the current days and disciplines 
text field, VIOLA 

2. Altering our training types and disciplines 

This is a piece of cake, if the gadget is clicked on by you (or it is altered in 
the refresh process, we simply have two variables curdis and curtype which 
we set to the various flag values for inputting data into our newtype. 

3. The Heartrate 

The heartrate, simply type in a number we go away and convert this string 
to a numerical value and store it in aH 3 disciplines for the current day, (This 
is because you only have one resting heart rate a day, not one for each 
discipline). Note how I've set the stringgadget entry length to 3 chars max. 
this is good cos your never going to have a heartrate of 999. and it means 
we don't have to check that a number to big to be a WORD value is going 
to be entered. 

4. Read todays Training 

The read todays training simply grabs the days training, dumps it back out 
to the ram.temp file (so that it can be re-edited as weN) and views it using a 
little text viewer. 



5. Refreshing the Gadgets via software for a new 
date or discipline 

When we do the refresh gadgets for a new date or discipline, you will notice 
that there is little border sometimes left round the 'unselecled* gadgets, this 
is something to do with the way Mark handles the gadgets in gadgetlib and 
I have not worked a way round it, I wiH ask mark if it can be changed, or 
maybe even (SHOCK HORROR) I'm just programming it wrong :•) 

Notice that the way the gadget refresh is programmed is modular ie: When 
there is a new date you have to refresh both the heartrate and the training 
type. So you have two refresh routines and you then caR both those with 
another routine called refreshall. However if its just a discipline that's 
changed all you do is call the refreshdis routine, this is an example of tidy 
modular code. 

6. The Graph Routine 

The graph routine simply takes the data for the current month loads a IFF 
backdrop of a graph (which was created with a separate little blitz prog), 
and then if the heartrate falls between certain values it uses some math to 
work out how high and where and what colour to plot the heartrate. 

7. Miscellaneous 

This programme is far from perfect, it assumes too much and the way the 
editor is called is a trifle crusty, however it suites my purpose fine and it is a 
good example of how to work round problems if lime or ability stops you 
from doing something (try writing a text editor one day and you'll see what I 
mean:-) 

I have put the little graph maker programme in the directory as wed, all this 
did was draw out my graph and print all the numbers in the right place and 
save it as an IFF, this is a good example of little pieces of utility code that 
can save you time, it would have taken heaps longer to design the graph 
and put all the little numbers down as brushes than it did to plot them out 
using bit of math, the results are accurate too. 

One interesting aside about the Graph creator is that it shows a way of 
cheating when you want to use non 8x8 fonts on a bitmap, simply open a 
fuM screen invisfble window to do your font drawing on and then convert to a 
bitmap afterwards. 

8. Functions and Statements 

The two requesters designed in tri.inc are good examples of how to make 
your code, smaller, more reliable and easy to understand and develop 

The yes no function just opens a window with a gadget list, waits (or a 
gadget event from that window , if its a yes the function returns true 
otherwise if its a no it returns false. This enables you to act on the result of 
the requester in your code. 

The alert function opens a window with a gadget list, waits for a gadget 
event from that window, if the ok gadget is pressed then the window closes 
and your programme is able to continue. 

Both the function and statement allow the programmer to display a line of 
centred text and allow the user to answer the requester using ESC=NO 
RETURN=YES keys thus making the programme more versitie. 

These are probably one of the best examples of tidy modular coding in the 
whole project so now that you have seen just what sort of things you can 
do with user defined functions/statements... Use them yourself. 

Well that's it basically, as I said for the athletes out there of you the actual 
documentation for USING Tri-Anaryse is on the disk, hope this gives you al 
some inspiration to start developing in Blitz. 

Seeya 



Roger. 
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BEGINNERS COLUMN 



Welcome. 

Hi there, and welcome to the first in what will hopefully be the 
first in a long line of tutorials on BASIC and in particular Blitz 
Basic. I say 'hopefully' because the success of this column 
depends on you, the user. 

I want to get as much feedback from you people on what you 
want so that I can run the beginners column and also I want to 
have a code clinic were you write your specific problems to us, 
and either myself or one of us here helps you on your way. 
When I say problems, I don't mean a 'how do I write pacman' 
letter but a letter asking about copper effects, or dual playfield 
would be fine. 

I am going to start at the very beginning so for some of you this 
will seem quite simple, but bare with me as we will be covering 
things thoroughly and even the more experienced of you may 
pick up little bits as we go along. 

VARIABLES. 



The first thing I want to Introduce that's part of BASIC (and 
indeed every programming language Is variables). 
A variable Is simply a place In memory where something is 
stored, rather than having to know this particular place in 
memory (which could be anywhereli) you simply can store 
things and retrieve things from a variable. Variable names can 
be up to xxx chars long, must not be a Reserved Word (ie: you 
could not have a variable called Window) and must either start 
with a letter or a underscore '_' 

Ex: 

These variable names are INVALID 

12345 can not contain numbers 

my name can not contain spaces 

bitmap is a Blitz Basic RESERVED WORD 

These variable names are VALID 
a perfectly acceptable but a bit obscure 

my.namethe underscore makes it A-OK 
counter this is fine 

.bitmap since the underscore precedes this it is 

not a RESERVED WORD 

Ok now we know what a valid variable name is its time to find 
out what we can put in them. There are six different types of 
primitive variable in Blitz Basic here is a table of them. 



TYPE 


Suffix 


Holds 


BYTE 


.b 


Signed: +/- 128 
Unsigned: to +256 


WORD 


.w 


Signed: +/- 32768 
Unsigned: +65536 


LONG 


.1 Signed: +/- 2147483648 
Unsianed: +4294967296 


QUICK 


q 


Signed: +/- 32768.0000 
Unsiqned: + 65536.0000 


FLOAT 


.f Signed: +/-9x10M8 
Unsigned: +/-9x10M9 


STRING 


s 


A collection of characters 



Ok now lets explain all that techno-jargon above. 

The following 3 variable types ( .b .w .I) can only hold whole 
numbers, not decimal or fractional values, they are also numeric 
variables so they can not hold characters of the alphabet or 
other symbols than numbers. 

.b (BYTE). A byte is one memory location, all the unsigned and 
signed jargon means that if the byte ONLY has to hold a 
POSITIVE number then it is unsigned, if it has to hold both 
POSITIVE and NEGATIVE numbers then it is signed. When a 
variable is signed it can only hold half the amount of its 
unsigned counterpart. The reason for this will be shown next 
issue when we go into 'how computers count' but for this month, 
just believe me. 

.w (WORD). A word is two consecutive memory locations, as 
above the maximum possible value of a word is halved when it 
becomes signed. 

.1 (LONG). A long is four consecutive memory locations, the 
signed, unsigned bit applies to this as well. 

The following two variable types are for holding real or decimal 
or fractional values they are 

.q (QUICK) A quick is four consecutive memory locations, the 
first two locations contain the whole number (the value before 
the decimal point) ttie last two locations contain the fractional 
value to 4 decimal places (the value after the decimal point), the 
signed, unsigned is again applicable to quicks. 

.1 (FLOAT) A float is four consecutive memory locations, the 
first two locations contain the whole number (the value before 
the decimal point) the last four locations contain the fraction 
value to up to 7 decimal places (I think) (the value after the 
decimal point). And yep you guessed it, the signed unsigned bit 
is once again applicable (phew) It uses FFP calculation. 

The next variable type is what you would use to hold anything 
(characters, symbols like % A $& A m, sentences etc etc) it is the s 
type or STRING 

NOTE: In keeping in line with most versions of basic a .s 
variable can also be specified by the '$' sign 

.s or $ (STRING) A string consists of a variable amount of 
memory locations which is entirely dependant on the length of 
the string, however, a string always ends in a NULL byte ('0'). 
The signed and unsigned bit DOES NOT APPLY to strings at 
all since they ARE NOT numerical values and arithmetic is not 
performed on them. 

Ok so now you know all the variable types, how do you use 
them well thats real easy you simply in BASIC say 

variable.type = value 

So for example you had a byte variable called myage and you 
wanted to put the number 22 into it you would type the following 
into blitz 

myage. b = 22 

Simple huh?, note that once myage is DEFINED as a BYTE 
variable (by the .b suffix) you donl have to put the .b on every 
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reference to it ie: 

myage.b *22 
myage - 1 5 



;l am 22 years old 
; myage is already defined as a 
;byte and I must nave found the 
fountain of youth 



However with a string you must always reference it as a string 
as it is possible to have a.b and a$ but not possible to have a.b 
and a.w. 

Ok, here are some examples of variables and the values that 
can be put into them. 



myage.b 


«120 


counter.w 


= 3000 


bignum.l 


= 1000000 


frac.q 


= 3.75 


bigfracf 


= 3.14576254675 


myname.s 


= "Roger" 


lastnameS 


= "Lockerbie" 



Ok, as you can see its all pretty easy stuff (you don't have to 
line up the '=' signs, I just did that for neatness, one thing to 
notice is that all literal strings have to be in quotes. 

So thats variables, lets look at some of the things we can do 
with them. 



anumber.b « 5+5 



;you can store arithmetic 
.results in them or 



firstnum.b « 5 ;you can add 

seconnum.b = 4 variables together or 

resultnum.b - firstnum + secondnum 

firstname.s » "Roger " ;notice the space 
secname.s ■ "Lockerbie" 
fullname.s * firstname.s + secname.s 

From the last example you will notice when we add to variable 
strings together we donl put quotes round them, you only put 
quotes round a string if you are literally defining a string ie: 

junlc.s - "This is junk * ; a literally defined string 
mrjunk.s - "And more" ;another literal string 
totaljunk.s » junk.s + mrjunk.s 

Fine. If your still with us then your doing good, Now here's a test 
for you, in the table below are some values, assuming each 
variable can be used to its UNSIGNED maximum place the 
most appropriate variable type to be used for it in the box next 
to it. The first one is done. 



Value 


Type 


112 


.b 


56 





1000 





79 




110001 





2.5 





BANANA 




3.752 




380 





3.7528675647 


— 



Ok the answers (including the one I did) from top to bottom 
should be. 



.b, .b, .w, .b, .1, .q, .s or $, .q, -w, .1 

If you got these wrong, then re-read the above sections so that 
you understand why we arrived at these answers. If so then 
your ready for the next little test 

Assume these ones are SIGNEDIII 



Value 


Type 


250 
32 

30000 
60000 


- 



Ok now the answers. 

.w, .b, .w, .1 

Now if you are confused remember that a SIGNED byte can 
only hold up to +/• 128 since we made the assumption that all 
the variables were going to be SIGNED (ie: possibly hold a 
positive or negative number) then we would have to say 250 
would be the next highest variable type ie a WORD. 

The next one is 32 which will fit into a BYTE no matter whether 
its positive or negative 

Likewise 30000 positive or negative will fit into a WORD 

60000 as a SIGNED value will not fit into a word, so we go to a 
long, if the variable that 60000 was never going to contain a 
negative number then we could assume it to be UNSIGNED 
and 60000 would have fitted into a word, however we didn't so it 
cant. 

What is the upchuck of all the Signed and Unsigned crap you all 
ask. Well simply.... 

If you put a negative number into a variable and then try to put a 
positive one in greater than the SIGNED maximum it wont work, 
Likewise if you put 255 into a .b variable and then try to put -120 
it wont work either, usually the easiest way in the beginning is to 
treat each type of variable as SIGNED and only put the 
SIGNED maximums into each, thats what we will be doing. 

I've got a bit heavy and deep in the last few paragraphs, so if 
your getting lost, don't worry, were back onto easy street now 
so lets actually do some programming. 

BEING ABLE TO SEE STUFF AND 
ENTER IT 



All this variable handling is nice, but unless you can actually 
display results and get people to enter something then its not to 
useful. Enter the following Blitz Basic Commands. 

Introducing Nprint and MouseWait 

Nprint is a blitz basic command to print stuff to the screen, the N 
in front of the print implies that once its printed something, the 
next thing printed will be on the next line down. 

Ok crank up blitz basic and type in the following programme. 



firstname$="Roger " 
lastname$ -"Lockerbie" 
Nprint firstname$-t-lastname$ 
MouseWait 
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Now compile and run it (if you are unsure of how to do this and 
other basic compiler stuff then read the relevant chapters in the 
user guide). 

What we have done is made the variable firstnameS = the literal 
string "Roger", lastname$ » "Lockerbie" and then added them 
together and printed out the result, the mousewait just waits for 
the left mouse button to be clicked so that we can see the result 
of our programme before we are returned to Blitz. 

Ok now lets look at a different way of doing this 

firstname$ ■ "Roger" 
lastname$ * "Lockerbie" 
fullname$ ■ firstname$ + lasfname$ 
Nprint fullname$ 
MouseWait 

Exactly the same result, however this time you can see that you 
can assign the resuft of adding variables to another variable. 

Right, now a little number example 

firstnum.b ■ 10 

secnum.b ■ 20 

thirdnum.b » 2 

sum.b=firstnum + secnum / thirdnum 

Nprint sum 

MouseWait 

and the number 20 should be printed on your screen because 
10 + 20/2 = 20. 

At this point some of you might jump up and down and say 10 + 
20 / 2 » 15 but it does not! This is because computers (and 
humans supposedly) work with what is known as Arithmetic 
Precedence. 

All that fancy saying means is that numerical sums are 
evaluated in a certain order. 

Maybe you remember the acronym BOOMAS from your school 
days, well here it is to refresh your memory. 

Brackets 

Of 

Division 

Multiplication 

Addition 

Subtraction 

So anything that is surrounded in brackets is evaluated first, 
followed by any division, then multiplication, then addition, then 
subtraction. 

So 10 + 20 / 2 is actually worked out by the computer as 



20/2 
+10 



*> 10 do division first 

s 20 no multiplication so do addition next. 



If you want to force the computer to evaluate in a certain order 
then you use brackets, so for example to get the computer to 
come up with the 15 some of you were expecting (by evaluating 
left to right the equation would become 
(10 + 20)/2 



Which says.... 

(10 + 20) => 30 
30/2 



do the brackets first 
15 and then the division 



So the same programme slightly modified would now give you 
15ie: 



firstnum.b = 10 

secnum.b « 20 

thirdnum.b = 2 

sum.b- (firstnum + secnum) / thirdnum 

Nprint sum 

MouseWait 

Groovy, you now have the basics of Arithmetic Precedence 
(see all these flash computer words are not that difficult after 
alt). 

Also just as you can use literal strings you can use literal 
numbers as well ie the above programme could have been 
written 

sum.b-(10+20)/2 
Nprint sum 
MouseWait 



Nprint( 10 + 20)/ 2 
Mousewait 

Ok so thats printing to the screen and basic variable handling 
covered, Now for some real stuff HI, Taking input from a person 
and doing something with it (processing It — jargon speak). 

Here Is a programme for you to type in 

;Simple 2 number adder by Roger 

firstnum. w * Edit(5) 

secnum .w - Edit(5) 

sum.w-firstnum+secnum 

Nprint firstnum + "+" + secnum + "-" sum 

MouseWait 

when you compile and run this programme you get a cursor, 
enter a number between 1 - 1000 and press enter 
you'll get a second cursor, enter a second number between 1 - 
1000 and press enter 

You'll then get a nice printout of the two numbers and the result 
of them added together, press the mouse to return to Blitz. 

CONGRATULATIONS!! Thats a genuinely useful (if somewhat 
simple) programme lets break it down and see what it does. 

Ladies and Gentleman... Edit lit 

The first thing you notice is that there is a new command in the 
listing called Edit. Edit is the same as INPUT in other versions 
of Basic and the parameter between the brackets is the number 
of characters that edit will take notice of. also the variable that 
receives Edit must be of a numerical type (.b .w .1 .q .f) ie: 

myvar. b= Edit(2) 
Nprint myvar 
MouseWait 

If you ran that programme, got a cursor and typed 200 myvar 
would only equal 20 as you told it in the edit command to take 
notice of the first 2 characters entered only. 



22 BliU User Issued 



firstnum.w » Edit(4) 

secnum.w ■ Edit(4) 

sum.w=hr$tnum + secnum 

N print firstnum + *+* + jecnum + V sum 

MouseWait 

So the first tine assigns a WORD variable called flrstnum to take 
up to 4 numerical digits entered by the user of the programme 
(YOU). 

The next line takes a second up to 4 digit number from you. 

The next line adds those two numbers together and stores them 
in the variable sum. 

The third line Is Npr int with some interesting stuff if you read 
along the Nprint line it first prints the firstnumber then it prints a 
literal plus sign on the screen then the second number, then the 
literal equals sign on the screen then the sum variable. 

So If you entered the numbers 100 and 40 H would look like this 

100 

40 

100+40=140 

Viola! Easy stuff huh, we are now going onto making stuff look a 
bit nicer and inputting strings. 

It would be nice to be able to prompt the user to type something 
In rather than just having a blank cursor, the Print statement will 
leave the cursor Just at the end of what its printed making It 
perfect for this purpose. 

The Amazing Mr Edits 

Ok now youVe got number Input and printing combinations of 
literal stuff and variables sussed, Its time to Introduce you to 
Edits. 

Which Is a piece of cake as Its just the same as Edit except you 
can type In anything and the variable that receives It must be a 
string variable { s or $) 



stuff$-edif$|5) 

If you ran that and entered "kazoongaa" as your data, a$ would 
equal "kazoo" 

Ok, time for our final programme for this instalment 

; Nice little Greeting programme 

Print "Please enter your first name: * 

hrstname$-Edit$(20) 

Print "Please enter your last name: " 

lastname$=Edit$(30| 

Nprint "* ;leave a nice blank line 

Nprint "Hi *+Rrstname$ + " * + bstnamej + " t 

My Names Mr Blitz Basic, A pleasure to make your 

acquaintance" 

MouseWait 



NOTE: The last Nprint statement in the above listing down to 
were ft says acquaintance" is actually to be typed In as one line, 
Its Just spilt into three because of the column width. 

Right, by this stage what should be going on should be self 
explanatory, I will mention one thing before I leave you, the use 
of comments. 

Comments in blitz basic are proceeded by a semicolon after the 
semicolon you can type what you like and it will be Ignored by 
the compiler until you start a new Kne. 

Commenting your code Is a MUST, it is a habit to get Into right 
from the beginning and one which every professional computer 
programmer does, the reason you do it is because while what 
you are doing In your code might seem obvious at the time, look 
at It in 2 days, weeks, years rime and it will look like gibberish. 
Put some comments in there and It wil MUCH easier for you (or 
someone else) to understand what the heck is going on. 

Righto mats It tor this issue, hope I have not bored you ail Into 
submission, the next newsletters beginners column will be how 
computers count, and how to get your programmes to make 
decisions (programme flow is the jargon term). Until then, 
WELL DONE, don't stop here though, experiment, look at other 
listings, look at the manuals, PLAY AROUND!! I No-one can 
teach you all about programming experimentation and learning 
through your mistakes and triumphs is the best way. 

Lastly, t want some feedback from you all If this Is useful, one 
type of feedback from the beginners, and another from the more 
experienced who are having problems In certain areas for my 
CODE CLINIC area. If I donl get any feedback, I'll assume no- 
one wants any Information and won't bother so write inlll 

Happy coding, and If you've written something (big or small) 
and want to share It with us, send It in. Next issue there will be a 
code competition, but for this Issue, the best thing I receive from 
both a beginner and an experienced coder will win a free copy 
of the new Improved user guide (if you already have it. Its a aS 
size booklet the new one not a4, then tell me that In your letter 
and if you win lit send you something else decent.) 

Happy Coding and Good Uxk..y^l 



Send Utters and Code or Entries to: 

Roger Lockerbie. 

C/- ACID SOFTWARE 

1/38 Rutland Rd, Mt Wellington 

Auckland 

New Zealand 

Or if you have other Blitz queries as well 

Roger Lockerbie 

Ct- ACID SOFTWARE 

Unit 10 St Kevins Arcade 

K 1 Rd, Auckland 

New Zealand 
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